For More Information 


We suggest several places to find more information about Pascal and the environment in which 
Oregon Software’s products are used. Many of these books are available from Oregon Software. 
Prices are subject to change without notice. 

Oh! Pascal by Doug Cooper and Mike Clancy. 

An easy-to-read Pascal course for the novice programmer. (W. W. Norton, $15.95) 

Programming in Pascal by Peter Grogono. 

A good course in standard Pascal, with lots of sample programs for experimenta¬ 
tion. (Oregon Software supplies one copy to each new customer.) 

Introduction to Pascal by Rodnay Zaks. 

A complete tutorial on Pascal designed to be read and understood by everyone. (SYBEX 
Inc., $14.95) 

A User Guide to the UNIX System by Rebecca Thomas and Jean Yates. 

A beginner’s tutorial on the UNIX operating system. (OSBORNE/McGraw-Hill, $15.99) 

UNIX Programmer's Manual Seventh Edition, Volume 2A. 

A collection of tutorials on the use of the operating system and its utility programs; 
Brian Kernighan’s descriptions of the system and the editor are especially helpful 
for new users. (Bell Laboratories, $60.00 for Volumes 2A and 2B) 

Pascal User Manual and Report by Kathleen Jensen and Niklaus Wirth. 

The first definition of standard Pascal. (Oregon Software supplies one copy to each 
new customer.) 

Algorithms + Data Structures Programs by Niklaus Wirth. 

A study of programming data structures, beginning with records, arrays, and sets — 
the fundamental structures — and progressing to those structures that are changed in 
value and structure by program execution. Full-length sample programs illustrate the 
stepwise refinements involved in developing Pascal programs. (Prentice-Hall, $25.95) 

Structured Programming by Dahl, Dijkstra, Hoare. 

Three monographs on methodologies of concept modelling (Dijkstra), data structur¬ 
ing (Hoare), and structured, hierarchical programming (Dahl and Hoare). (Academic 
Press, $20.00) 

Elements of Programming Style by Kernighan and Plauger. 

A practical demonstration of the principles of good programming and the use of 
common sense. The authors criticize and rewrite sample programs from various texts 
on programming. (McGraw-Hill, $3.95) 

Systematic Programming: An Introduction by Niklaus Wirth. 

A description of the technique of constructing and formulating algorithms in a sys¬ 
tematic manner, intended as general mathematical background rather than prac¬ 
tical study of coding. (Prentice-Hall, $23.95) 

UNIX Programmer's Manual f Seventh Edition, Volumes 1 and 2B. 

Volume 1 is the Programmer's Reference , containing explanations of all programs 
that make up the UNIX operating system. Volume 2B is the Programmer's Manual , 
a collection of papers on various aspects of installing and using the operating sys¬ 
tem for program development. Topics include various compilers, the assembler, and 
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the UUCP network. (Bell Laboratories, $100.00 includes Volumes 1, 2A, and 2B) 

Concurrent Euclid, the UNIX System, a nd Tunis by Holt, Graham, Lazowska, Scott. 

An introductory text on concurrent programming, the techniques used to design and 
implement operating systems, computer networks, real-time control and embedded 
microprocessor systems. (Addison-Wesley, $15.95) 

Pascal Newsletter 

Published quarterly, Oregon Software’s Pascal Newsletter, which contains status reports 
on all of our Pascal products, announcements of new versions of software and new 
products, and various technical articles. 

Temporarily, the newsletter is the sole publication for the Oregon Pascal Users Society 
(OPUS), an organization dedicated to the sharing of information between Oregon 
Software and its customers. Oregon Software is not affiliated with OPUS, but we en¬ 
courage its activities and provide space for an OPUS column in our Pascal Newsletter, 
until OPUS begins to publish its own newsletter. OPUS membership is free. To join, 
write: 

Oregon Pascal Users Society (OPUS) 

Bruce Williams 
c/o EOCOM 
15771 Redhill Ave. 

Tustin, California 92680 
(714) 730-5051, ext. 302. 

The Pascal Newsletter 

Published by the Pascal Users’ Group, The Pascal Newsletter , is available at $10 
for a one-year subscription. Contact: 

Pascal Users’ Group 
2903 Huntington Rd 
Cleveland, Ohio 44120. 
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Style note: Page numbers in boldface ( 0 ) indicate the defining use of the term. 


A 

alignment, byte boundaries, 2-33 
allocating memory, 2-24 
alphabetize, tee structure, manual 
ASCII format, 3-6 
assembly language, tee PASMAC 


B 

bltslze function, 2-34, 3*21 
Blaise Pascal, 1-2 
boolean operators, 3-18 
boundary, alignment of user-defined types, 
2-33 

breakpoint, 1-7, tee alto Debugger,breakpoint 
commands 

break procedure, 3-16 

/buff: n I/O control switch, 2-9 

Bug Reports, tee Trouble Reports 


C 

cache memory, 2-28 
case statement, 3-13 

example with otherwise, 3-13 
otherwise clause, 3-13 
chaining, 2-23 

channels, input and output, 2-19 
overlay load, 2-16 
characters, data type, 3-6 
character strings, tee Dynamic String Package 
literal, 3-4 

check compilation switch, 2-3 
(check embedded switch, 2-7 
chr function, 3-30 
Clancy, Mike, Info-1 
close procedure, 3-15, 3-26 
colon notation, 2-2, 2-5 
command lines, reading of, 2-46 
consent PB switch, 5-9 
compilation, 1-1 

errors, 1-2, 2-62, tee alto error mes¬ 
sages 

examples, 1-1, 2-7 
syntax, 2-1 

compilation switches, 1-4, 2-2 
check switch, 2-3 


debug switch, 1-6, 2-3, 2-60, 4-2 
double switch, 1-8, 2-2, 2-18 
errors switch, 1-4, 2-3 
list switch, 1-4, 2-3 
nacro switch, 2-3, 2-19 
naiu switch, 2-2 

10 - reverses effect of <switch>, see 
< switch > 
object switch, 2-3 
own switch, 2-2, 3-8 
profile switch, 1-8, 2-3, 4-32 
standard switch, 2-3 
test switch, 2-3 
times switch, 2-3 
walkback switch, 2-2 
workspace switch, 2-2 
pascall switch, 2-2 
compiler directives, {include, 3-8 
compiler errors, 2-76 

consistency checks, 2-76 
overflow, 2-76 

compiler installation, tee Release Notes 
compiler optimizations, tee optimization 
concatenation of source files, 2-1, 2-23, 
5-18 

conformant array parameters, xiv, 3-2 
examples, 3-4 
syntax, 3-3 

constants, structured, 3-9 
COISTS psect, 2-22 
Cooper, Doug, 1-1, Info-1 
cross-reference utilities, 5-13 

PROCREF procedure lister, 5-15 
XREF identifier lister, 5-13 
customized error messages, 2-39 


D 


Dahl, O.-J., Info-1 

debug compilation switch, 1-6, 2-3, 2-60, 
4-2 

(debug embedded switch, 2-5 
Debugger, 4-1 

assigning values to variables, 4-14 
breakpoint commands, 4-6 
breakpoints, 1-7 
command summary, 4-31 
data commands, 4-13 
debug compilation switch, 4-2 


t 
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debugging external modules, 4-26 
example, 1-6 

execution control commands, 4-8 
execution history, 4-11, 4-20 
information commands, 4-17 
initialization of, 2-19 
overlaying of, 4-30 
stack commands, 4-20 
summary of commands, 4-31 
tracking commands, 4-11 
utility commands, 4-18 
declaration sections, interleaving of, 3-8 
delete procedure, 3-26 
example, 3-26 

deleting files, see delete procedure 
DIAGS psect, 2-22 
Dijkstra, E<W., Info-1 
direct access, 2-10, 3-15 
dispose procedure, 2-24, 2-28, 3-30 
disposing of memory, 2-24 
double compilation switch, 2-2, 2-18 
example, 1-8 

(double embedded switch, 2-5, 2-18 
double precision, 2-2, 2-5, 2-18 
colon notation, 2-2, 2-5 
example, 1-8 
dynamic link, 2-26 
Dynamic String Package, 2-18, 5-18 
and (include directive, 5-18 
capabilities, 5-18 
example, 5-20 
library creation, 2-18 
procedures and functions, 5-19 
STRING, 5-18 
string declaration, 5-18 
string examples, 5-18 
use of, 5-20 


JE 

EBNF syntax diagrams, 3-40 
notation, 3-38 
els processor switch, 2-4 
embedded switches ($), 3-4 
(check switch, 2-7 
(debug switch, 2-5 
(double switch, 2-5, 2-18 
examples, 2-4 
(indexcheck switch, 2-7 
(list switch, 2-6 
(uin switch, 2-5 
(no- reverses effect of <switch>, 
see <switcb> 

(ova switch, 2-5 
(pascall switch, 2-5 


(pointercheck switch, 2-7 
(profile switch, 2-6 
(rangecheck switch, 2-7 
(stackcheck switch, 2-7 
(standard switch, 2-6 
(valkback switch, 2-5 
entry points, list of, 2-78 
p(gtln, 2-47 
support library, 2-19 
error correction, see Debugger 
error handling, 2-39 
error messages, 1-2, 1-3 
compilation, 1-2, 2-61 
compiler, 2-76 
customized, 2-39 
run-time, 1-3, 2-35, 2-72 
error recovery, run-time, 3-14 
errors, 1-2 

compilation, 1-2 
compiler, 2-76 
fatal, 2-35 
I/O, 2-35 

run-time, 1-3, 2-35, 3-14 
run-time detection, 2-39 
errors compilation switch, 1-4, 2-1, 2-3 
error trapping, I/O errors, 2-37 
error walkback, 2-2, 2-5 
executable file, 1-1 
execution history, see Debugger 
exltst procedure, 2-43 
declaration, 2-43 
status values, 2-43 
extended-instruction set, 2-4 
extended-range integers, see unsigned in¬ 
tegers 

extended-range variables, 3-18 
Extended Backus-Naur Form, see EBNF 
syntax diagrams 
extended precision, 2-2, 2-18 
extensions, default, 2-77 
I/O support, 3-14 
language, 3-8 
syntax, 3-8 

external directive, 2-11, 3-9 
external file access, 3-14 
external libraries, 1-14.4 
header file, 2-14.4 
external modules, 3-11, 3-8, 3-9 
and double precision, 2-18 
debugging of, 4-26 
definition, 2-11 
definition example, 2-11 
example program, 2-12 
FORTRAN routines, 2-11,2-14, 2-14.2 
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global variable reference, 2-11 
identifiers, 2-11 
linking errors, 2-12 
MACRO routines, 2-11, 2-14 
tnoaain embedded option, see em¬ 
bedded switches 

nonain option, see compilation switches 
external procedures, 5-23 


F 


file, 1-1 

closing upon procedure exit, 2-44 

cross-reference, 5-13 

default extensions, 2-77 

executable, 1-1 

“header”, 5-18 

input, 2-1 

listing, 1-4, 2-1 

object, 1-1 

output, 2-1 

overlay description, 4-30 
profile, 1-8, 4-32 
PROSE, 5-42 
source, 1-1 
statement map, 1-6 
symbol, 1-6 
temporary, 2-10 
text, 3-6, 3-30 
file buffer, 2-9 

default size, 2-9 
size of, 2-9 

file control switches, see I/O control switches 
file dump, example, 2-41 
file extensions, default, 2-77 
files, renaming of, 3-26 
fin processor switch, 2-4 
floating-point numbers, format of, 3-6 
outputting of, 3-17 
foreground operation, 2-49 
formatter, see PASMAT 
for statement, 3-30 

FORTRAN, called from Pascal, 2-11,2-14, 
2-14.2 

restrictions, 2-14.3 
forward directive, 2-12 
fpp processor switch, 2-3 
FRUI command, 2-49 
function return value, 2-26 
structured types, 3-25 


getlia procedure, 2-46 
declaration, 2-47 
example, 2-49 
parameters, 2-47 
gatpoa procedure, 2-54, 3-16 
example, 2-55 
parameters, 2-54 

got procedure, 2-10, 3-15, 3-30, 3-31 
GLOBAL psect, 2-22 
/go I/O control switch, 2-9 
Grogono, Peter, 1-1, Info-1 
“grow” psects, 2-17 


H 


heap, 2-24, 2-27 

fragmentation of, 2-28 
free list, 2-17 
PlKOBE, 2-28 
Hoare, C. A. R., Info-1 


I/O control switches, 2-9, 3-14 
/buff:n switch, 2-9 
examples, 2-9 
/go switch, 2-9 
/afa switch, 2-9 
/odt switch, 2-9 
/aeok switch, 2-10 
/aiz«:n switch, 2-10 
/apaa switch, 2-l0 
switch summary, 2-9 
/teap switch, 2-10 
I/O errors, 2-9 

trapping of, 2-9 
I/O error trapping, 2-37 
I/O functions, 2-50 

and standard Pascal, 2-50 
lazy I/O, 2-50 
I/O page, 2-25 
I/O support extensions, 3-14 
identifier, predefined, 3-32 
identifiers, extension to standard, 3-8 
aaxint, 3-6 
valid characters, 3-5 
finclude directive, 2-19,2-40,2-44,3-8, 
5-18 

examples, 2-44 
syntax, 2-44, 3-8 
Indent PB switch, 5-9 
index, see alphabetize 
lindexcheck embedded switch, 2-7,3-30 
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initializing the support library, 2-27 
initializing variables, 2-46 
input file, 2-1 

installation, compiler, see Release Notes 
integer overflow, 3-31 
integers, range of values, 3-18 
unsigned, 2-57, 3-6, 3-18 
interrupt vectors, 2-23 
ioerror function, 2-37, 2-55 
iostatun function, 2-37, 2-38.2, 2-55 
ISO Standard Pascal, xiv, 3-1 
alternate symbols, 3-5 
implementation definitions, 3-6 
Pascal-2 extensions, 3-8 
recent changes, 3-1 


J K 


Jensen, Kathleen, 1-1, 3-1, Info-1 
Kernighan, Brian, Info-1 


L 


language extensions, 3-8 

structured constants, 3-9 
lazy I/O, 2-49 
Librarian, 2-18 
examples, 2-18 
libraries, run-time, 2-23 
support, 2-19 
system macro, 5-36 
LI1K command, 2-15 
example, 2-8 

Linker, 1-1, 2-15, see also overlays 
list compilation switch, 2-3 
example, 1-4 

llist embedded switch, 2-6 
listing, 1-4 
file, 1-4 

page heading, 1-4 
listing file, 2-1 
literal strings, 3-4 
LOAD command, 2-25 
look-ahead, 2-27 
loophole function, 3-21 
example, 3-22 


M 


MAC command, 5-37 
MACRO-11, see PASMAC 
called from Pascal, 2-14 
MACRO assembler command, 2-3, 5-37 
macro compilation switch, 2-3, 2-19 
macro package, see PASMAC 


main compilation switch, 2-2 
Inaim embedded switch, 2-5 
manual, index, see index 
manual purpose, xi 
naxint identifier, 3-6, 3-30 
memory, typical arrangement, 2-27 
typical layout, 2-23 
memory allocation, 2-24 
user-defined types, 2-33 
memory map, 2-40 
example, 2-41 

memory usage, monitoring of, 2-27 
/M:n Linker option, 2-27 
mod function, 3-25, 3-30 
monitoring memory usage, 2-27 
multiple input files, 2-1 
multiple source files, 2-44 


N 

VevOK function, 2-27, 3*30 
new procedure, 2-24, 2-27, 2-28, 3-30 
/nf s I/O control switch, 3-9 
all pointer, 2-7 

no- reverses effect of <switch>, see <switch> 
aoioerror function, and /go switch, 2-9 
aoioerror procedure, 2-37 
non-standard features, 3-25 
program parameters, 3-25 
returning of structured types, 3-25 
nondecimal notation, 3-18 
aonpamcal directive, 2-11, 2-14, 2-52, 

3-9 

null root segments, 2-17 


O 

object compilation switch, 2-3 
object file, 1-1 

object module libraries, see Librarian 
Octal Debugging Technique (ODT), 2-9 
octal notation, 3-18 
octal output, 3-16 
/odt I/O control switch, 3-9 
examples, 2-10 
OPERROPAS, 2-39 
optimization, 2-59 

base address calculation, 2-60 
Boolean evaluations, 2-59 
constant folding, 2-59 
dead code elimination, 2-59 
expression targeting, 2-60 
redundant branching, 2-60 
redundant expressions, 2-60 
register assignments, 2-59 
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opt lots PASMAT switch, 5-3 
Oregon Pascal Users Society (OPUS), Info-1 
Oregon Software, xi, 2-70 
Pascal Newsletter, Info-2 
Trouble Reports, 2-70 
organization, see manual, index 
origin declaration, 3-20 
examples, 3-20 
syntax, 3-20 
otherwise clause, 3-13 
output specifications, 2-1 

colon notation, 2-2, 2-5, 2-18 
default field widths, 3-7 
octal notation, 3-10, 3-18 
scientific notation, 3-7, 3-17 
overlays, 2-10 

and getlin, 2-47 
Debugger, 4-30 
examples, 2-10 

extended memory, 2-10, 2-17 
load channel, 2-10 
low memory, 2-15 
null root segments, 2-17 
/0:n Linker switch, 2-10 
program segments, 2-10 
virtual, 2-10, 2-17, 2-27 
virtual job, 2-15 
owi compilation switch, 2-2, 3-8 
and GLOBAL psect, 2-22 
$own embedded switch, 2-5 


P 

PtAREA temporary storage, 2-47 
directive, syntax, 3-9 
page procedure, 3-7 
parameters 

conformant array parameters, 3-2 
passing of, 2-26 
procedure and function, 3-2 
Pascal, Blaise, 1-2 
paecall compilation switch, 2-2 
Ipascall embedded switch, 2-5 
Pascal standard, xiv, tee alto ISO Standard 
Pascal 

Pascal Users’ Group, Info-2 
PASMAC, 2-14.1, 3-29, 5-13 

and system macro library, 5-36 

begin macro, 5-29 

command line, 5-25 

design of MACRO-11 procedures, 5-23 

endpr macro, 5-30 

examples, 5-24, 5-33 

fane macro, 5-27 

macro definitions, 5-24 


parse macro, 5-27 
placing in system macro library, 5-36 
predefined types, 5-31 
proc macro, 5-26 
purpose of, 5-23 
reave macro, 5-29 
eave macro, 5-28 
var macro, 5-28 
PASMAT, 5-2 

command line, 5-3 
directives, 5-4 
examples, 1-4, 5-7 
limitations, 5-6 
options switch, 5-3 
portability mode, 5-5 
PB formatter, 5-9 

cement switch, 5-9 
example, 5-10 
formatting rules, 5-12 
indent switch, 5-9 
PlCODE psect, 2-22 
pldisposo procedure, 2-27, 2-18 
declaration of, 2-29 
example, 2-30 
parameters, 2-29 
PlDTIL psect, 2-22 
PlGBOV psect, 2-17 
PlGBVH psect, 2-17 

plgtla entry point, 2-47, tee alto getlin 
procedure 

plinew function, 2-27, 1-28 
declaration of, 2-29 
example, 2-30 
parameters, 2-29 
PlEOBE psect, 2-17 
PMA, 2-22, 2-40 

Ipointercheck embedded switch, 2-7, 
3-30 
pointers, 2-7 
all, 3-30 
all values, 2-7 
stack pointer, 5-27 
use of, 2-56 

Post-Mortem Analyzer (PMA), 2-22,2-40 
predefined functions and procedures, 3-26 
predefined identifiers, 3-32 
prod function, 3-30 

procedure walkback, 1-3, 2-2, 2-5, 2-35, 
tee alto walkback 
processor switches, 2-3 
•is, 2-4 
t is, 2-4 
fpp, 2-3 
sia, 2-4 
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PROCREF utility, 5-15 
command line, 5-15 
example, 5-16 
limitations, 5-16 

profile compilation switch, 2-3, 4-32 
example, 1-8 

Iprof lie embedded switch, 2-6 
profile file, 1-8 
Profiler, 4-32 
example, 1-8 

execution requirements, 4-32 
output explanation, 4-33 
usage of, 4-32 
warnings, 4-36 
program heading, 3-8 
file parameters, 3-8 
program sections (“psects"), 3-23 
attributes, 2-22 
COVSTS psect, 2-22 
DIAGS psect, 2-22 
GLOBAL psect, 2-22 
P$C0DE psect, 2-22 
P$DTVL psect, 2-22 
P$GR0V psect, 2-17 
P$GRTH psect, 2-17 
PlKORE psect, 2-17 
SHIFTS psect, 2-22 
TABLES psect, 2-22 

program segments, and overlays, 2-16 
PROSE, 5-20, 5-38 

basic text units, 5-39 
command line, 5-42 
directive format, 5-40 
directive summary, 5-63 
examples, 5-41, 5-52, 5-57 
index directives, 5-54 
input control directives, 5-43 
“keep” buffer, 5-52 
miscellaneous options, 5-44 
output control directives, 5-55 
page control directives, 5-47, 5-48 
paragraphs, 5-49 
parameter values, 5-40 
title directives, 5-47 
psects, see program sections 
purpose of manual, xi 
put procedure, 2-10, 3-15, 3-31 

R 

random access, 3-15, 2-10, see also getpos 
and setpos procedures 
simulated, 2-54, 3-16 
trangecheck embedded switch, 2-7, 3-30 
reading command lines, 2-46 


readln procedure, 3-16, 3-30 
read procedure, 3-16, 3-30 
real numbers, 2-18 
format of, 3-6 
outputting of, 3-17 
recursion, 3-36 
ref function, 3-31 
registers, 2-26 

saving of, 5-28 
renaae procedure, 3-36 
example, 3-26 

renaming files, see renaae procedure 
reserved words, 3-32 
reset procedure, 2-9, 2-38, 3-7, 3-14, 
3-26, 3-30 
parameters, 3-14 
syntax, 3-14 
return link, 2-26 

rewrite procedure, 2-9, 2-38, 3-7, 3-14 
and siae:n I/O control switch, 2-10 
parameters, 3-14 
syntax, 3-14 
round function, 2-58 
R PASCAL command, 2-1 
run-time error messages, 2-72 
run-time error reporting, customizing of, 
2-39 

OPERRO.PAS, 2-39 
UERROR.PAS, 2-39 
run-time errors, 1-3, 2-35 
procedure waikback, 1-3 
recovery from, 3-14 
waikback, 1-3, 2-35 
run-time library, 2-23 


S 

•ayerr procedure, 2-37, 2-38.1, 2-40 
example, 2-38.2 
scientific notation, 3-7, 3-17 
/seek I/O control switch, 2-10, 3-15, 
3-16, 3-31 
example, 3-16 

seek on text files, examples, 2-55 
simulated, 2-54 

seek procedure, 2-10, 2-54, 3-15 
segments, and overlays, 2-16 
setpos procedure, 2-54, 2-55, 3-16 
example, 2-55 
parameters, 2-55 
sets, 3—6, 3-31 
use of, 5-20 

.SETTOP system directive, 2-27 

SHIFTS psect, 2-22 

sia processor switch, 2-4, 2-22 
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single-character mode, 2-0 
single precision, 2-5, 2-18 
sits function, 2-30, 2-34, J-ll 
/•izn:n I/O control switch, 1*10 
source, 1-1 
file, 1-1 
program, 1-1 

source file concatenation, 3-33, 5-18 
source program, 1-1 
spacn function, 2-27, 2-18 
data types, 2-28 
declaration of, 2-28 
example, 2-30 

/span I/O control switch, 3*10 
stack, 2-19, 2-27, 5-23 
contents, 2-24 
default size, 2-27 
reserving space, 2-30 
space function, 2-28 
stack frame, 2-25 

(stackcheck embedded switch, 2-7 
stack frame, 3-35 
stack pointer, 2-17, 2-24, 5-27 
standard, tee ISO Standard Pascal 
standard compilation switch, 2-3 
(standard embedded switch, 2-0 
standard Pascal, xiv, see also ISO Standard 
Pascal 

START.OBJ, and virtual overlays, 2-17 
statement map file, 1-6 
storage allocation, 2-33 
pre-defined types, 2-33 
size and bitslze, 2-34 
user-defined types, 2-33 
string processing, 5-18 
strings, tee Dynamic String Package 
declaration of, 3-16, 5-18 
examples, 5-18 
literal, 3-4 

structure, manual, tee organization 
structured constants, 3-9 
examples, 3-10 
multidimensional arrays, 3-12 
style notes, xvi 
nscc function, 3-30 
support library, 2-19 

data definitions, 2-19 
entry points, 2-19, 2-78 
error-control module, 2-39 
initialization procedure, 2-27 
initializing of, 2-19 
LEBDEF.PAS, 2-19 
library work area, 2-19 
switches, 2-2,2-4, 2-18, tee alto I/O con¬ 


trol switches, compilation switches, 
embedded switches, processor switches 
compilation, 2-2 
compilation examples, 2-7 
embedded ($), 2-4 
I/O control, 2-9 
processor, 2-3 
symbol file, 1-6 

syntax diagrams, Pascal-2, 3-33 
system device (ST:), 2-15, 2-46 
system macro library, and PASMAC, 5-36 


T 

TABLES psect, 2-22 
/t«ap I/O control switch, 3-10 
termination status, tee nzLtnt procedure 
test compilation switch, 2-3 
text files, 3-6 

text formatting, tee PROSE 
Thomas, Rebecca, Info-1 
tian function, 3-37 
example, 3-27 

tines compilation switch, 2-3, 2-46 
tinentaap procedure, 3-28 
example, 3-28 
parameters, 3-28 

traceback, tee walkback, procedure 
Trouble Reports, 2-76 
trunc function, 2-58 
two’s complement arithmetic, 2-57 
type checking, suppression (loophole), 
3-21 

type coersion, tee loophole function 


U 


UERROR.PAS, 2-39 

Of lout procedure, unsigned floating-point 
conversion, 2-57 
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Documentation Evaluation Report 


Pteenl-t VJ.l Uw Manual Update Fuka|« No. S 
PDP-ll/RT-11 


Good documentation is as important as good software. We at Oregon Software are well aware that 
you expect both, so we value your responses. Use this form to write down comments and suggestions, 
which will help us improve the quality and usefulness of our publications. If you require a written 
response, submit your comments on a Trouble Report. 


Rate the following items on a scale of 1 to 5, with 5 being the highest rating. 

-Initial impression _Ease of finding information 

-Organisation -Accuracy 

-Ease of reading -Ease of updating the manual 

What changes in the documentation, in your opinion, are most useful?_ 


What aspects of the update package need improvement? 


What errors have you found in this update package? Include page numbers. 


Name - Site # 

Company _— Date 
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Mailing Instructions 


Domestic. After filling out the report, cut along the vertical dotted line to remove the punched 
holes. Then fold this page so these instructions arc hidden and the BUSINESS REPLY MAIL permit 
faces out. Secure the loose fold with staple or tape, then mail. 

International. Please enclose this page in an envelope and return it to your distributor. If you do 
not have a distributor, return the report directly to us. (Unfortunately, we cannot supply prepaid 
postage for overseas respondents.) 

Thank you in advance for your response. 
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Release Package Checklist 


SOFTWARE! Pascal-1 Development System 
VERSION! VS.ID 
OPERATING SYSTEM! RT-11 
DATE OF RELEASE! January IS, 188* 

This release package contains the following marked items. If a discrepancy exists between the marked 
items and the contents of yonr release package, please contact Oregon Software at (503) 245-2202 
immediately. 

13^ Pascal-2 software on: 

G Magnetic tape. G 800 bpi G 1600 bpi 
JSf Floppy disk. 

G Cartridge disk. 



Pascal-2 User Manna/, Second Edition. 

£3^ Documentation Update Package, Update No. 2. 

,E( Release Notes, including the Installation Guide. 

1ST Standard Pascal User Reference Manual by Doug Cooper. 
^ Programming in Pascal by Peter Grogono. 

An assortment of Pascal Newsletters. 

J5^ Extra Trouble Report forms. 

G Extra “Request to Amend" forms. 

G License agreement. 
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This publication, or parts of it, may be copied for use with the licensed software described herein, 
provided that all copies include this notice and all copyright notices. 


RESTRICTED RIGHTS LEGEND 

Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in 
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of the Federal Acquisitions Regulations (FARs). 
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Phone: 503-245-2202 

© 1985 Oregon Software, Inc. All Rights Reserved. Printed in USA, January 1985. 

Pascal-1, Pascal-2 and Oregon Software are trademarks of Oregon Software, Inc. 

DEC, PDP, RSX, RSTS/E and RT-11 are trademarks of Digital Equipment Corporation. 









Pascal-2 V2.1D/RT-11 Release Notes 


The information contained in this document describes the Pascal-2 V2.1D release package. In these 
notes you will find: 

• A list of problems (“bugs”) we’ve fixed in this release. 

e Notes on changes in the documentation and on how to update the user manual, 
e Miscellaneous notes of interest to Pascal-2 users, 
e The Installation Guide. 

These release notes should be read before attempting to install the compiler and utilities on your 
system. The “Documentation Notes” section of the release notes should be read before attempting 
to insert the change pages from the update package into the user manual. 

Style Notes 

This document follows these style conventions: 

Text: 

Pascal reserved words, predefined symbols, switches and compiler directives are in boldface 
typewriter: begin, write, (include, aonain. Portions of examples referred to in the 
text appear in boldface typewriter (the type style used in examples). Program, system 
and file names are in upper-case letters in the same type style as the text: SAMPL, 
VMS, SAMPL.PAS. 

Program Examples: 

Commands that you should enter are in underlined boldface typewriter: BP1 El. These 
commands assume a carriage return at the end. 

Program Listings: 

The Pascal-2 compiler accepts any combination of upper-case and lower-case characters. 
Examples in this manual have Pascal words in lower case and have user-defined words 
with an initial capital letter and other capitalisation as needed for readability, as shown 
in this program fragment: 

procedure Shoe; 
begin 

SoaeUserictlon; 
vritela(Result); 

•id; 


Terminology: 

We use standard terms as they are used in documents describing the RT-11 operating 
system. 
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Changes in the Software 

Version 2. ID is primarily a maintenance up-date; changes in software between Versions 2. ID and 
2.1C consist for the most part of fixes for previously known problems. 

Problems We’ve Fixed 

Version 2. ID corrects the following problems: 

Record field as a parameter 

The compiler generated bad code when certain nested record fields were passed as a parameter. 
Negative stack oflbet for common su bex p r essions 

Depending upon the location of a variable’s declaration, two identical calculations involving certain 
functions, including sin and cos, could have different results. The library routines for the functions 
caused the compiler to reference a negative offset from the stack pointer. 

Wrong results from Integer comparison 

A comparison between an integer and a subrange that is an element of a packed record produced 
an incorrect result. 

Incorrectly addressed real variable 

Certain globally allocated real variables were incorrectly addressed. As a work-around, reducing the 
size of the program seems to remove the error. 

Dynamic string package errors 

The Insert routine printed the error message Array subscript out of bounds when the com¬ 
bined length of the two input strings exceeded the target string’s length. Now, the insert string is 
concatentated onto the end of the target string and truncated. 

The Concatenate routine reported errors when the string to be concatenated overflowed the target 
string. The input string is now truncated to fit. 

TSPagc directive didn't work 

On listings, (page incremented the page number incorrectly. 

Reserved Instruction trap error 

Using a packed record containing integers in a nested procedure call caused a reserved instruction 
trap. 

Illegal Instruction gave "compiler writer error" 

Using certain illegal instructions resulted in the error message for internal problems instead of the 
appropriate error message. 

No error message 

The compiler failed to give an error message for attempts to pass an element of a packed structure 
as a variable-parameter. 
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Problems We've Fixed 


The compiler Incorrectly need RO for procedure cells 

The compiler failed to save the contents of the BO register after nonpascal procedure calls. 

Mtmory protection violation 

A memory protection violation occurred in isolated instances when the valne of RO was not initialized 
before adding the offset. 

Snts generated bad eoda 

Set constructor expressions of the form [varl .. var2] generated bad code at times. 

Sat type produces wrong results 

The declaration and statement 

type a * eet of (one.two,three); 
var bra; 

begin 

b:« [oie,three]; 
write (b *[]<*[]); 

end. 

produced a set of 256 items merged with a set of 3 results. 

Function returns Incorrect result 

The compiler incorrectly changed bit ienghts to byte lengths when a function returned a structured 
type. 

Bit optimisations incorrect 

Compiler optimization of certain user-defined procedure calls produced an incorrect sequence of 
execution. 

PB formatter rejects "nonpascal" 

The formatter failed to recognize the nonpascal directive. It now treats nonpascal exactly like the 
external directive. 

String comparison range wrong 

For string comparisons, ord(char) was in the range 0. .255 instead of *128.. 127. The range is now 
correct. 

Unsigned characters tr e a t e d as signed 

The compiler treated 8-bit characters as if they were signed numbers when the character was 
optimized. 

Assignment statements caused failure 

A complicated series of assignment statements involving arrays of type real previously failed. 

Compiler consistency checks reported 

Certain instances of undeleted temps in procedure... were fixed in 2.1D. 
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Linkage failure daring Installation 

A missing continuation character in the file UTILS.XM, which builds the utilities, caused a failure 
at the point where XREF is linked. 

Misleading error message for nonexistent files 

The compiler printed the error message “Unknown Pascal runtime error” for an attempt to compile 
a nonexistent file or a file containing a line lode of a nonexistent file. 

Debugger overlays do not work for XM monitor systems 

XMDBG.COM, the XM monitor command file that links Debugger modules with a Pascal program, 
now correctly overlays Debugger modules. 
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Problem* W*V» Fixed 


Documentation Notes 

The documentation for Pascal-2 Version 2.1D ineladee the second edition of the Pucni-2 User 
Msnasl, which documents the enhanced V2.1 software, and Update Package No. 2, documenting the 
2.10 features. (Update Package No. 1 was previously distributed and all changes then noted have 
been incorporated into the manual.) We have expanded a number of sections, including “External 
Modules,” “Resident and Cluster Libraries,” and “The Debugger Guide.” The expanded sections 
provide new information and clarify and correct earlier material, at user suggestion. Update Package 
No. 2, records these changes and is made up of “change pages” for insertion into the user manual 
at the appropriate place. The update package’s cover sheet should be inserted into the manual just 
before the first contents page, to keep a history of changes to the manual. 

The Release Notes, containing the Installation Guide, is a companion document of the Fiscal-2 User 
Manual and should be kept with that manual for reference. 


Miscellaneous Notes 


Official ISO Standard for Pascal 

The Pascal language now officially has an international standard. The International Standards 
Organization, in a vote tallied this summer, adopted a standard language definition for Pascal. The 
action followed earlier adoption of an American standard that is a subset of the international one, 
lacking only conformant array parameters. 

The sequence leading to adoption of the Pascal standard began in December 1982, when ANSI and 
IEEE agreed on the American standard, identical to the international draft standard except for 
conformant array parameters. At the same time, the Joint Pascal Committee of ANSI and IF.F.F 
recommended adoption of the international standard Level 1 (including conformant array parame¬ 
ters) to the U.S. committee known as X3J9, which then voted “yes” on the international standard 
at the next meeting. Previously, the U.S. was one of three “no” votes. This time, the ISO standard 
passed with no dissenting votes and one abstention. 

Peppered throughout the Language Specification of the user manual are references to the “draft” 
standard. The word “draft” can be ignored. (Change pages were not issued for this change.) 

Packing Problems 

Several users have uncovered bugs in Pascal-2 , s packing of records and arrays. We believe that it 
may be necessary to modify the packing algorithm slightly in version 2.1E in order to correct these 
problems. If such a change is necessary, users who have programs that involve the reading and 
writing of packed records or arrays may have to convert their data files to the new format in order 
to use V2.1E. This new version will be released in roughly six months; if the packing conversion 
is necessary we will make every effort to clearly document when and how to follow the conversion 
process. 


Stack Overflows 

Especially large stack overflows, those that extend beyond the heap and into the program code 
sections of memory, have the potential for causing serious problems. In some cases it is possible for 
the error to prevent the appropriate error message from being printed or the program from properly 
terminating. In some rare instances, the condition can even lead to the disruption of the computer’s 
operating system. It is the programmer's responsibility to avoid such excessively large overflows by 
controlling the size of local variables and value parameters passed to procedures. 


e 
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EXITST Creates a Walkbaek for ‘Severe Error* Status (4) 

The Exltst procedure is a support library routine that sets the termination status of a program 
and stops the program when a “severe error” status is detected. The procedure’s integer argument 
determines the termination status for any program that calls it. When a “severe error” status of 4 
is passed, the procedure also invokes the poet mortem analyser to create a walkbaek of the program 
execution from the point of failure. 
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Pascal-2 V2.1D/RT-11 Installation Guide 


This guide describes the way to load the RT-11 Pascal-2 software on yoar system. The V2.1 software 
runs on RT-11 V4 and V5. 

To install Pascal-2 V2.1 for RT-11, follow the steps below: 

1. Copy all of the Pascal-2 files to the system device (ST:); 

2. Select a compiler depending on your system monitor; 

3. Select a run-time library depending on yoar processor hardware options; 

4. Compile the Pascal-2 utility programs; 

5. Set the compiler’s listing file page site to a value other than 60 octal (optional); 

6. Extract the Debugger modules from the support library for use in overlaying the Debugger 
against user programs. 

7. Delete files no longer needed (optional). See Appendix B for a sample deletion command. 

These steps are described in detail in the following paragraphs, and are illustrated by an example 
that can be found in Appendix B of thi3 guide. The installer should read this guide in its entirety 
before attempting to install the software. Upon successful completion of the installation, the Pascal-2 
system is fully operational as described in the PsscsJ-2 User Manual. 

This guide contains two appendices. Appendix A lists the files contained in the release media. 
Appendix B shows a typical XM installation. 


Copying the Pascal-2 Files to the System Device 

Copy all of the distribution files to the system device (ST:) using the ASSI6I and COPT commands, 
as shown below: 

• ASSIQ1 ST PI -- assigns ST: as default device 

.COPT MTO: ST: -copies magtape to system device 

If your system disk is a floppy disk, or is otherwise limited in available space, you should first read 
the following sections and select the files that are necessary for your system. Then copy those files 
to your system. The minimal system requires one compiler file and one library file. You may wish to 
build more than one system disk and, for example, install the compiler, library, and Debugger on 
one disk and the utility programs on a second system disk. 


Selecting a Compiler for Your System Monitor 

There are two compilers supplied with Pascal-2. Your choice of a compiler depends on the version 
of the RT-11 monitor you intend to use. There are four possibilities: the Base-Line (BL) monitor, 
the Single-Job (SJ) monitor, the Foreground-Background (FB) monitor, and the eXtended-Memory 
(XM) monitor. 

If you are using either the BL or the S J monitor, choose the compiler called SJ.SAV. If you use the 
XM monitor, select the compiler called XM.SAV. 

The FB monitor does not leave sufficient memory to run the Pascal-2 compiler. If you are using 
the FB monitor, you must switch to either the SJ or XM monitor (using the BOOT command) before 
compiling a Pascal program. Once compiled, programs may be linked and run under the FB monitor. 


Install-1 










Paacal-S VS.ID/RT-11 Installation Guide 


The XM compiler shoald be chosen over the S J compiler where possible because it uses the extended 
memory or “virtual" overlay capability and gives faster compilations. 

When you have selected a compiler file, copy it to ST:PASCAL.SAT with the following command, 
which assumes the default device is ST:. 

COPT SJ.SAT PASCAL.SAT -installs SJ compiler 

or: 

. COPT IM.SAT PASCAL .SAT -installs XM compiler 

You may then delete S J.SAV and XM.SAV, or yon may leave them on your system disk for use under 
their respective monitors. (See Appendix B.) 


Selecting a Run-Time Library 

There are four run-time libraries supplied with Pascal-2, one for each combination of processor 
instruction sets. Choose the library that matches the configuration of the processor that will run 
your compiled programs. 

The possible configurations are: 

e FPP — a processor with the Floating Point Processor instruction set. The FPP is standard 
equipment on the PDP-U/60 and optional on all new PDP-ll’s and the LSI-11/23. If your 
processor includes the FPP, select the LIBFPP.OBJ library. 

e FIS — the Floating Instruction Set. The FIS hardware is an option available for the LSI-11, 
LSI-11/2 and some older PDP-11 processors. If your processor has FIS, select the LIBFIS.OBJ 
library. 

• EIS — Extended Instruction Set, for hardware support of multiply, divide, and long shift 
instructions. EIS is standard equipment on all new PDP-11 and LSI-11/23 processors and an 
option available for all older LSI-1 l’s and PDP-ll’s. If your processor has neither FPP nor FIS, 
but does have EIS, then select the LIBEIS.OBJ library. 

• For processors with no extended or floating instructions, select the LIBSIM.OBJ library. This 
library operates on any LSI-11 or PDP-11 regardless of its actual configuration, but does not 
take advantage of any optional hardware. 

After selecting a library file, copy it to ST:PASCAL.OBJ with the following command or one similar 
to it, depending on the processor configuration. In the command, ST: is the default device. 

COPT LIBFPP.OBJ PASCAL.OBJ. -FPP library 

You may then remove the other library files, or leave them on the system for use with other 
configurations. (See Appendix B.) 

Compiling the Utility Programs 

Five Pascal-2 utility programs are supplied in source form and are automatically compiled and linked 
by one of two command files, UTILS.SJ and UTILS.XM. UTILS.SJ prepares the utility programs for 
execution under the SJ, FB and BL monitors; UTILS .XM prepares them for execution under XM. 
Feel free to examine these command files before executing it indirectly using one of two commands: 

.WIILS, SI 

or: 

■ WIILS.tt 
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Compiling tho Utility Program* 


Upoa completion of UTILS, the utility programs nre available for use u described in the Utilities 
Guide of the Pascal-2 User Manual 

In UTILS.XM all of the utilities most be linked as Virtual jobs” made up of virtual overlays because 
their load images are larger than 16K. (The XM monitor can not load a program with a root segment 
larger than 16K.) The Pascal-2 file START.OBJ is used in the link process to create a null root 
segment, tricking the Linker into loading the oversized program. The Paacal-2 User Manual contains 
a detailed description of this technique for user programs in Pascal. 

When UTILS completes, you may then delete the extra .OBJ and .MAP files left on the disk by the 
UTILS command file. (See Appendix B.) 


Setting the Page Size of the Compiler’s Listing File 

The command files RTPAGE.COM and XMPAGE.COM, supplied with the Pascal-2 release, provide 
a means for changing the number of lines per page of the SJ and XM compilers' listing file, 
respectively. This feature allows for the use of odd-sized printer paper or for special printing needs. 

Before executing either command file, you must modify the lines-per-page value in the fifth line of 
data in the command file. (The first line of data is the file to patch.) The normal page size (in octal) 
is 66, not counting header lines. 

I Command f 11# to patch tho SJ vorsion of Pascal to chaago 
I tho lino* per page of a listing fllo 
I 

I Chaago tho number nn (octal) to aaothor value. In octal 
! that represents the suaber of lines per page of a listing file 
I that you require. 

1 

R SIPP 
ST:PASCAL 

3075 

2 

on —-lines per page 

*T 

*C 

where nn is the desired page size in octal. The value ‘3075’ is the base address of the symbol PACELI, 
and the actual value in the supplied command filemay be different. The value ‘2’ is the byte offset 
from the base address of the location to patch. Values for the page size and byte offset must not be 
changed. 

After editing the appropriate file, execute it indirectly with the command: 

iRTPAGE - -for SJ installation 

or: 

swffseg -for XM installation 
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Extracting Support Library Modules for Debugger Overlays 

Before users eaa overlay the Debugger against their programs, the command file EXTRAC.COM 
mast be executed. This command file, supplied with the release kit, extracts from the Pascal support 
library the Debugger and other key modules used by the XMDBG.COM (for XM systems) and 
SJDBG.COM (for S J systems) command files, also in the release kit. (Users can then execute either 
XMDBG.COM or SJDBG.COM to overlay the Debugger and their Pascal programs.) EXTRAC.COM 
places the modules onto the system device (ST:), with the extension .DBG. It need only be executed 
once. 

The command file can be executed with the indirect (at-eign) processor, as shown: 

■ iETTRAC * 


Installing Pascal-2 With Pascal-I 

The Pascal-1 system compiler can be renamed to allow simultaneous use of Pascal-1 and Pascal-2. 
Then, the files for both systems can be present on the system device without conflict, provided that 
the compiler/library versions and upgrade levels are themselves compatible. (For example, Pascal-1 
V1.2K is compatible with Pascal-2 V2.0K, and V1.3C is compatible with V2.1C; V1.2K, however, 
is not compatible with VI.3C. 

The object library PASCAL.OBJ can be shared by the two systems (as long as the two system 
versions are compatible); the libraries supplied with Pascal-2 include all of the Pascal-1 routines. 
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Appendix A: Distribution Files 


Compiler* 

SJ .SAT Pascal-2 Compiler for SJ monitor 

XX . SAT PaacaJ-2 Compiler for XM monitor 


Object Libraries 

LIBFPP.OBJ Library for processor* with FPP and EIS 
LIBFIS.OBJ Library for processor* with FIS and EIS 
LIBEIS.OBJ Library for processors with EIS only 
LIBSH.0BJ Library for base-level processors 
TIBJOB .OBJ Header module for XM virtual jobs 
STABT .OBJ Nall root module for XM virtual overlays 


Command Files 


EZTBAC.COM 
SJDBO .COM 
XMDBQ .COM 
BTPAGE.COM 
ZMPAGE.COM 
UTILS .SJ 
UTILS .XM 


Support library module extractor for Debugger overlays 

Debugger overlayer for SJ monitor 

Debugger overlayer for XM monitor 

SJ listing-file page sue patches 

XM listing-file page sise patches 

SJ, FB and BL utility installer 

XM utility installer 


Utility Programs 

PASMAT. PAS 
PB .PAS 
ZBEP .PAS 
PBOCBE.PAS 
PBOSE .PAS 
STRIBG.PAS 
PASMAC.MAC 
SATEBB.PAS 
UEBBOB.PAS 
OPERBO.PAS 
LIBDEP.PAS 
CSITTP.PAS 
CSIPBO.PAS 
FIZAB6.PAS 
FIZIBC.PAS 
FIZOUT.PAS 
STMDCL.PAS 
STMCOD.PAS 
CITIUM.PAS 


Program formatter 
Pascal Beautifies 
Cross-references 
Procedure cross-referencer 
Text formatter 
String package 

MACRO-ll interface package 
System error message printer 
User error reporting module 
Support library error routine 
Support library definition* 

Command String Interpreter (CSI) type definitions 

CSI procedure definitons 

CSI argument parser 

CSI fiaclude file handler 

CSI temporary output manager 

CSI symbol table declarations 

CSI symbol table manager 

CSI command-line number converter 


Demonstration Programs 

* Vary from release to release 
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Appendix B: Typical XM Installation 


The following steps illustrate the installation of Pascal-2 from magtape on a processor that includes 
the FPP floating point processor. The Pascal-2 compiler for the extended memory (XM) monitor is 
selected. 


. ASSIG1 ST PI - assigns ST: as the default device 

■ COPT MTO: ST: 

. COPT LIBFPP.OBJ PASCAL.OBJ -selects the FPP library 

.CQPT a. SAT PASCAL, SAT -selects the XM compiler 

.dPTILS.XM -builds the utilities 

R PASCAL --builds PASMAT 

PASMAT/TIME/VORKSPACE=650 


I Tha folloviig link will round up tka root to U and put tha extra 
( aaaory on tha haap 
R LIRE 

PASMAT,PASMAT-START.TIRJOR/O:20000// 

PASMAT,PASCAL/T:i 

// 

PtGROV 

*C 

R PASCAL -builds PB 

PB/TIME 
r Lin 

PB. PB=STRAT, TIR JOB/TJ: 20000// 

PB,PASCAL 

//PtGROV 

*C 

R PASCAL - builds XREF 

XREF/TIME 
R Lin 

XREF=START,TIRJOB/O:20000// 

XREF,PASCAL/T:1 

// 

PtGROV 


*C 


R PASCAL -builds PROCREF 

PROCRE/TIME 
R Lin 

PROCRE,PROCRE=START,TIRJOB/U:20000// 

PROCREF.PASCAL/T:1 

// 

PtGROV 

*C 

R PASCAL -builds PROSE 

PROSE/TIME/VORKSPACEs700 
r Lin 

PROSE,PR0SE=START,TIRJOB/O:20000// 

PROSE.PASCAL/T:1 

// 

PtGROV 

*C 
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• tlMTMK -sets listing page size to nine other than 66 octal (optional) 

mime -extracts library modules for Debugger overlaying 

B PIP -cleans up the system disk (optional) 

•SiL SAT. BL.5AT/D -Remove the compilers, leaving PASCAL SAV 

» L1BFPP.OBJ.LIBFIS.OBJ.LIBEIS.OBJ.LIBSIM.OBJ/D 

• PASMAT.OBJ. PB. OBJ.PEF.OBJ.PBOCBE.OBJ.PBOSE.OBJ/D 

♦ PASMAI.MAP.PB.MAP.IBEF.MAP.PBQCBE.MAP.PBOSE.mP/P 
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